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1.  Using  Commercially  Produced  Models  in  Vulnerability/ 
Lethality  Analysis 

Vulnerability/lethality  (V/L)  analysis  fundamentally  relies  on  the  ability  to  define 
for  a  computer  the  3-D  space  occupied  by  a  target  (tank,  truck,  helicopter,  etc.)  and 
the  ability  to  calculate  geometric  intersection  along  shot  lines  through  those  targets. 
Historically,  models  were  purpose-built  for  analysis  needs1;  however,  preexisting 
geometric  models  created  by  vehicle  vendors  have  been  more  frequently  used  over 
the  last  15+  years.  Using  a  preexisting  model  offers  the  possibility  of  a  faster  and 
less  expensive  analysis  process,  but  in  order  to  make  use  of  these  preexisting 
models,  they  must  be  converted  to  the  BRL-CAD  .g  format  used  by  the  US  Army 
Research  Laboratory’s  (ARL’s)  V/L  analysis  tools  (particularly  MUVES).2 

Current  practice  is  to  convert  commercial  geometries,  which  typically  use  Non- 
Uniform  Rational  B-Spline  (NURBS)  as  their  fundamental  geometric  shape 
representation  method,  to  triangle  mesh-based  geometry.  There  are  many  potential 
paths  for  such  conversions;  one  simple  possibility  involves  converting  all  shapes  in 
the  commercial  system  to  STereoLithography  (STL)  meshes  and  reassembling 
them  manually  in  BRL-CAD.  Unfortunately,  while  simple,  such  methods  are  not 
only  labor  intensive  but  lose  all  hierarchy  and  metadata  information  contained  in 
the  original  commercial  system. 

In  the  early  2000s,  John  Anderson,3  ARL,  wrote  a  plugin  for  the  PTC 
Pro/ENGINEER  (Pro/E)  commercial  computer-aided  design  modeling  system  that 
converted  triangle  meshes  generated  by  Pro/E  directly  to  the  BRL-CAD  .asc  ASCII 
file  format,  generated  combinations  based  on  the  Pro/E  geometry  hierarchy,  and 
also  preserved  some  metadata  information  (such  as  object  color).  This  proved  to  be 
a  successful  conversion  strategy,  and  the  original  converter  has  been  used  ever  since 
to  convert  commercial  models.  In  2008  Robert  Parker,4  ARL,  extended  this 
converter  to  be  more  flexible  about  tolerances  during  model  tessellation  (the 
process  that  generates  triangles  from  the  original  NURBS  shapes)  and  added  a  few 
other  behavioral  improvements.  Since  that  work  was  completed,  there  has  been 
little  change  to  the  converter’s  code  or  design. 

Although  the  converter  code  was  stable,  the  PTC  products  have  evolved  over  time. 
Pro/E  has  been  replaced  by  Creo  Parametric5  and  the  original  Pro/Develop  toolkit 
used  for  (part  of)  the  original  Pro/E  to  BRL-CAD  plugin  has  been  removed  in  Creo 
Parametric  3. 6  This  means  that  existing  Pro/E  and  Creo  Parametric  version  2 
converter  binaries  will  no  longer  work,  and  the  code  will  have  to  be  updated  to 
more  modern  standards  before  target  modelers  at  ARL  can  handle  vendor-supplied 
models  created  in  newer  Creo  versions. 
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Fortunately,  much  of  the  original  converter  was  written  using  Pro/TOOLKIT  rather 
than  Pro/Develop  and  therefore  it  requires  only  minimal  updating.  However,  years 
of  use  have  also  resulted  in  a  number  of  feature  requests  to  improve  the  work  flows 
of  target  modelers  utilizing  the  converter.  As  the  code  needed  to  be  modernized  in 
any  case,  some  of  the  simpler  requests  have  also  been  targeted  for  implementation: 

.  Writing  geometry  directly  to  BRL-CAD’s  binary  .g  file,  instead  of  staging 
through  the  ASCII  .asc  file  format. 

.  Allowing  users  to  specify  model  parameters  (“attributes”  in  BRL-CAD 
terminology)  that  they  wish  to  have  preserved  in  the  conversion. 

•  Allowing  users  to  specify  attributes  to  be  used  for  generating  “user- 
friendly”  BRL-CAD  object  names  to  be  used  in  lieu  of  the  Creo  part 
numbers. 

All  of  these  goals  were  achieved,  and  in  the  process,  the  original  converter  code 
was  extensively  refactored  and  updated. 

2.  Installing  the  Creo  to  BRL-CAD  Converter 

Installing  the  converter  is  simply  a  matter  of  placing  the  correct  files  in  the  correct 
locations  within  the  PTC  Creo  file  hierarchy.  The  .zip  file  will  decompress  the  files 
to  the  correct  relative  positions  if  the  proper  root  level  directory  is  chosen.  For 
example,  if  you  are  using  Creo  Parametric  3  M100  in  a  standard  C:\Program  Files 
installation  location,  decompress  the  .zip  file  in  the  directory  C:\Program 
Files\PTC\Creo3.0.  This  may  require  administrator  privileges,  depending  on  how 
Creo  was  originally  installed. 

3.  Converting  a  Creo  Parametric  Model 

When  the  converter  is  supplied  the  name  of  an  existing  BRL-CAD  file  as  an  output 
target  and  that  file  is  the  output  of  a  previous  conversion  from  Creo  Parametric  3 
via  this  converter,  the  converter  will  create  and  update  only  those  objects  that  are 
either  newly  added  or  changed  since  the  last  conversion.  If  this  is  undesirable 
behavior,  either  the  conversion  should  target  a  new  .g  output  file  or  the  modeler 
should  remove  specific  objects  they  wish  to  reconvert. 

All  BRL-CAD  objects  are  stored  using  millimeters,  so  Creo  objects  will  be 
converted  to  use  those  units  on  a  per-part  basis. 

Figures  1  through  22  illustrate  the  step-by-step  model  conversion  process,  using  the 
open  source  Pro/E  model  for  the  Neol973  phone.7 

Approved  for  public  release;  distribution  is  unlimited. 

2 
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Fig.  2  Select  the  desired  file  to  open.  If  you  have  a  large  model,  you  are  probably  looking 
for  an  assembly  file.  Part  files  can  be  converted,  but  they  do  not  encode  multiobject 
hierarchies. 
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Fig.  5  Select  the  Datum  Display  Filters  drop-down  menu  next  to  the  Annotation  Display 
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Fig.  17  Construct  2  comma-separated  lists  of  attributes  using  a  text  editor.  The  first 
indicates  the  parameters  to  use  when  constructing  objects  names.  The  second  lists  parameters 
to  preserve  as  attributes  on  the  corresponding  BRL-CAD  objects. 
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Fig.  18  Select  File/Creo-BRL  to  run  the  converter 
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Fig.  19  The  converter  dialog  offers  a  variety  of  settings  that  impact  the  conversion  process. 
Populate  the  various  data  entry  boxes  in  the  lists  of  Creo  model  parameters.  Select  All  for 
verbose  logging.  (This  is  not  necessary,  but  is  sometimes  useful  when  debugging  problems.) 
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Fig.  20  Once  the  desired  settings  are  selected,  select  Go  to  run  the  conversion.  As  the 
conversion  is  running,  messages  should  be  displayed  in  the  status  bar.  (This  can  sometimes 
fail  if  the  conversion  hits  an  interface  update  blocking  operation,  but  generally,  it  should 
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Fig.  21  Once  the  conversion  is  complete,  select  Dismiss 


Fig.  22  Inspect  the  resulting  .g  file  to  ensure  the  result  is  as  expected 
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4.  Other  Features  of  the  Creo  to  BRL-CAD  Converter 


Users  of  the  plugin  dialog  will  note  that  a  number  of  data  entry  blocks  are  not 
documented  in  the  previous  section’s  conversion.  Although  these  settings  will 
normally  work  using  their  default  values,  the  figures  and  descriptions  in  this  section 
briefly  document  the  purpose  of  each  option  so  users  will  know  when  they  might 
want  to  adjust  them. 

The  starting  identifier  is  used  to  set  the  initial  region  ID  used  when  creating  regions 
to  hold  objects  (Fig.  23).  The  converter  begins  with  this  ID  number  and  then 
increments  the  ID  for  each  new  region  created  during  conversion. 


Fig.  23  Starting  identifier  number 

There  are  5  settings  that  all  pertain  to  tessellation,  as  identified  in  Fig.  24.  These 
define  the  range  of  settings  that  may  be  used  by  the  converter  when  trying  to 
tessellate  NURBS  geometry,  in  order  from  least  accurate  (and  smallest)  to  most 
accurate  (and  largest).  Modelers  may  wish  to  experiment  with  these  settings  on 
individual  parts  to  get  a  feel  for  their  behavior. 
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CREO  to  BRL-CAD  Converter  _  X  | 
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Fig.  24  Tessellation  settings 

The  converter  does  have  some  logic  defined  that  will  attempt  to  recognize  features 
defining  holes  in  solids  and  replace  them  with  constructive  solid  geometry  (CSG) 
Boolean  shapes,  but  this  feature  is  disabled  by  default  (Fig.  25).  It  is  somewhat 
experimental,  and  modelers  are  cautioned  that  applications  requiring  only  triangle 
meshes  cannot  use  outputs  generated  with  this  option  disabled. 


Fig.  25  Disable  use  of  CSG  in  output 
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Surface  normals  on  triangles  are  not  written  out  to  bag-of-triangles  (BoT)  solids  by 
default  (Fig.  26),  but  the  BRL-CAD  BoT  primitive  does  support  them.  They  will 
be  saved  during  conversion  if  this  option  is  enabled. 


CRE'O  to  BRL-CAD  Converter 


GTC01-MME014og.txt 


Output  File  Name:  |  GTC01-MUE01  .g| 
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Fig.  26  Write  surface  normals  when  outputting  triangle  meshes 

Rejecting  nonsolid  BoT  tessellations  (Fig.  27)  is  an  experimental  feature,  which 
may  be  overly  aggressive  in  rejections  as  currently  implemented. 
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Fig.  27  Reject  nonsolid  object  tessellations 

The  converter  can  optionally  use  the  bounding  box  of  an  object  to  create  an  ARB8 
primitive  if  all  tessellation  options  fail  (Fig.  28),  but  generally,  the  resulting  shape 
will  be  too  crude  of  an  approximation  of  the  original  shape  for  V/L  analysis 
purposes.  This  option  is  primarily  for  debugging  but  can  also  be  used  to  generate  a 
more  complete  conversion  of  the  geometry  hierarchy,  with  the  bounding  box 
primitives  indicating  objects  requiring  manual  work  to  complete. 
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Fig.  28  Use  bounding  boxes  to  represent  objects  if  mesh  generation  fails 

Creo  Parametric  provides  the  ability  to  suppress  features  on  solids  (Fig.  29),  which 
in  effect  allows  the  converter  to  interact  with  a  simplified  approximation  of  the  fully 
detailed  solid.  This  can  allow  successful  tessellation  in  cases  where  the  fully 
featured  model  will  not  succeed,  and  it  will  tend  to  generate  simpler  meshes  when 
the  tessellation  does  not  have  to  use  many  small  triangles  to  approximate  fine 
details.  The  check  button  enables  suppression,  and  once  enabled,  threshold 
parameters  may  be  entered  for  holes,  chamfers,  and  roundings  to  determine  which 
features  end  up  suppressed.  Enabling  this  process  will  1)  slow  the  conversion  if 
many  features  need  to  be  suppressed  and  2)  may  damage  the  working  copy  of  the 
model  if  features  cannot  be  restored  post-conversion.  In  the  latter  case,  it  is 
important  to  quit  Creo  Parametric  after  conversion  is  complete  without  saving  the 
Creo  model  (and  write  the  inadvertent  changes  back  to  the  on-disk  copy). 
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[Toooooo 

Min  Angle  Control  Value: 

koooooo 

Max  to  Min  Control  Steps: 

~20 

[yf  Facetize  everything  (Evaluate  booleans,  no  CSG) 

□  Write  surface  normals 

]  Reject  BoT  tessellations  unless  they  pass  the  solidity  test 

□  If  a  part  fails  to  tessellate.  use  its  bounding  box  instead 

^  Ignore  small  features 

'i 

Minimum  hole  diameter  (mm):  0.000000 

Minimum  chamfer  dimension  (mm):  0.000000 

Minimum  round  radius  (mm):  0.000000 

Go 

Dismiss 

Current  status: 

Not  Yet  Processing 

Fig.  29  Creo  Parametric  provides  the  ability  to  suppress  features  on  solids 


5.  Developers  Notes:  Working  with  Creo  Parametric 

Important  points  for  developers: 

•  Match  your  version  of  Visual  Studio  to  the  version  used  to  compile  the 
specific  version  of  Creo  Parametric  you  are  targeting — for  version  3,  Visual 
Studio  2012  with  the  vl  10_xp  toolset). 

.  Ensure  you  install  the  development  library — by  default,  it  is  not  enabled  for 
installation  in  Creo  Parametric  3  (See  Figs.  30  and  31). 

.  You  will  need  read- write  access  to  the  Creo  Parametric  directories  for 
development — the  plugin  cannot  be  run  successfully  without  performing 
the  installation  step,  even  for  debugging  purposes. 
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Software 

Agreement 


PTC* 


Application  Selection 

Installation  path  for  all  applications: 


Jd  ►  C:  ►  Program  Files  ►  PTC  ► 

- 

Choose  from  the  list  below 

|  Customize  Applications, 

1 

Application 

Version 

Install  Size 

Diagnostic  Reporting 

Status 

▼  3  PTC  Creo 

PTC  Creo  Common  Fies 

3.0  Ml 00 

0 

Required 

PTC  Creo  Direct 

3.0M100 

299  MB 

No  Licenses  found 

PTC  Creo  Distributed  Services  Manager 

3.0  Ml  00 

86  MB 

No  Licenses  found 

PTC  Creo  Layout 

3.0M100 

24  MB 

No  Licenses  found 

PTC  Creo  Options  Modeler 

3.0  Ml 00 

24  MB 

No  Licenses  found 

PTC  Creo  Parametric 

3.0  M100 

0 

□ 

Update  from  Ml 00 

PTC  Creo  Simulate 

3.0M100 

0 

□ 

Update  from  Ml 00 

▼  □  PTC  Mathcad 

□  PTC  Mathcad  Prime 

3.1  F000 

615  MB 

New 

- 

Total  Space  Required  0  MB  B  Av a  ar  - 

f~l  Enable  diagnostic  data  collection  for  these  applications. 

Help  us  improve  PTC  products'  When  you  install  PTC  products,  you  also  download  PTC  Diagnostic  Tools 

These  diagnostic  tools  collect  information  about  your  hardware  and  how  you  use  the  software.  These  tools  do  not  collect  your  name,  address,  email 
or  other  personal  information.  PTC  is  committed  to  protecting  your  privacy  and  the  content  of  your  documents  is  NEVER  collected.  With  a  paid 
hcense,  you  can  disable  the  diagnostic  functionally  if  you  desire  to  do  so  Click  here  for  more  details 


Fig.  30  When  you  reach  the  Application  Selection  stage  of  Creo  Parametric  installation, 
locate  the  Customize  Applications  button 
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Fig.  31  Under  the  Command  Configuration  tab,  locate  the  PTC  Creo  Parametric 
TOOLKIT  and  ensure  it  is  enabled  for  installation.  If  you  wish  to  have  Creo  Parametric  load 
the  TOOLKIT  license  at  startup  (you  do  if  you  are  doing  any  major  development)  update  the 
configuration  in  the  Command  Configuration  tab.  See  the  Creo  documentation  for  more 
details. 

Once  Creo  Parametric  is  correctly  set  up,  it  is  time  to  compile  the  plugin.  The  source 
code  for  this  plugin  is  part  of  a  standard  BRL-CAD  source  archive,  located  in  the 
directory  src/external/Creo.  Unlike  most  of  BRL-CAD’ s  tools,  the  Creo  plugin  is 
designed  to  be  built  as  a  stand-alone  project.  The  Creo  plugin  uses  the  CMake  build 
tool  to  manage  its  configuration  process  and  Microsoft  Visual  C++  to  perform  the 
actual  compilation,  as  illustrated  in  Figs.  32-38. 
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Fig.  32  Visual  Studio  version  and  toolset  are  both  set  in  the  initial  CMake  screen 
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X 


Where  to  budd  the  binaries: 
Search: 


|C:AteersAJ5ef/Doaimencs/brlcadiAflcad/SPC/eMternaa^CftEO 

1  [Browse  Source..,  1 

C:AJsers/UserA?oajment5/brlcad^irlcad/src/ext)ernal/CREO/buld 

[  Browse  Build,,. 

IH  Qnoupe d  Q  Advanced  [  ^  Add  Entry  ]  [  H  Remove  Entry  ] 


Stop 


Generate  Current  Generator:  Visual  Studio  11  2012  Win64 


CM*  be  W*r  ning  at  CHe  SceLi  s  t  a .  txt  :  6  3  Une  s  s  age )  : 

C: /Program  Filea/ERICAD  X.XX.X  dosan't  exiat  -  set  EfilCAD_ROOT_DI R.  to  the 
location  of  your  EEL-CAD  inatallation. 


CMake  Warning  at  CMareLists . Gxt : £7  (message) : 

Cl /Program  Frles/PTC/Creo  XXX  doesn't  exist  -  set  CREC_PCOT_EIP.  to  the 
location  of  your  CHZO  installation. 


CMebe  tsror  *t  CMekelaets, txt :70  (scejsage>: 

Correct  path  aettinga  to  continue  with  configure 


Configuring  incomplete,  errors  occurred! 

See  also  "C : /Ua e r a /U ser / Do ctcte nt a /hr Icad/br lead/ sr c/ external /CREO/bui Id/ CMa 


Fig.  33  The  first  time  Configure  is  run,  the  process  will  halt  with  an  error.  This  is  expected 
behavior,  because  the  locations  of  BRL-CAD  and  Creo  Parametric  have  not  yet  been  specified. 
(Both  are  required  for  a  complete  configuration  process  to  succeed.) 
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A  CM ake  3.5.2- 


Wher e  is  i he  source  code  t  O AJsers/Usw^Docum^Esytrlcedflu'Iced/src/e^  tarnal/CR£Q| 


6row$e  Source.- 


Where  to  build  the  binaries:  C^/Users./Use^DocumefTfcsybrlcad^jrlcad/src/external/CREO/build 
Search: 


Browse 


Build.., 


F  I  Grouped  E  Advanced  [  ^  Add  Entry  H  Remove  Entry 


Name 

BRLCAD ROOT DLR 


Value 


ri.mii 


m 


CREO_ROOT_  DIR 


'C/Proaram  File;-  PTC/C  re  o  XXX 


a 


A  Select  Path  for  CREO_ROOT_DIR 

«  Program  Fifes  fr  PTC  »■  CreoB.O  ► 


5eoirft  CreolO 


Organize  T 
J*  CREO 


New  folder 


j-ai  Libraries 
j]  Documents 
Musk 

B  Pictures 
:  -J  Subversion 
Q  Videos 

L  Computer 
&  OSDisk  fC:> 


Name 


U  M100 


ii; 

Date  modified 
1/4/2017  9:54  AM 


# 

Type 

Fife  folder 


-  * 


Folder  Creo  3J0 


Select  Folder 


Cancel 


CMake  '/raining  at  Ola te Lists.  :  fi 7  ires  saga  : 

C:/ Program  Filai/PTC/Cras  XXX  ds«tnri  exist  -  s*t  CREO_flOOT_02tH  to  th« 
location  of  your  CREO  insiallation. 


Fig.  34  For  BRLCAD_ROOT_DIR  and  CREO_ROOT_DIR,  select  the  correct  directories 
to  identify  the  versions  of  Creo  Parametric  and  BRL-CAD  being  used  to  build  the  plugin 
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File  Tools  Options  Help 


Where  Is  ihe  source  code;  C^^=AJ*r/DoojTipentE^Hcad^rtcad/Erc/E^erfid/CREQ| 
Where  to  build  the  braries :  C ;  AJsers/ystt/DocumenSs^lt^^rltad/src^estiemal/aREO/bLjId 
Search: 


Brovtse  Spurge...  j 


Browse;  Buid. ... 


Grouped  H  Advanced  ■£*  Add  Entry  Rer  ■ ,-e  Ertr  , 


Name 

Value 

BRLCAD  ROOT  DIR 

creo_root_di"r 

^**^1  pnf  ®  >j| 

C  [/Program  Files/PTC/C  r«D  3,0 

Press  Configixe  to  update  and  dispSay  new  vakxs  in  red,,  tfien  press  Generate  to  generate  selected  build  flies, 

I  Configure  Generate  ]  Current  Genesr  a  tor;:  Visual  Studio  11  2012  Win64 

Hooe:  The  following  BRI-CAD  dlHsJ  is/are  not-  present  in  C: /Program  Filea/PTC/Creo  3.  Q/MIOO/Gdobk} 

libbg.dLi 

libbn.dli 

lihhrcp .dll 

libbu.dll 

lihgdia.ffl.dll 

liblz4.dll 

libmug.dll 

lifapZt.dll 

libxt.dll 

lib  z  inyeshread .  -dll 

libvd* . dl 1 

libvdb.dll 
openKUSas .dll 
regoK , dll 
y2O30.dll 
zlibl.dll 

Be  aware  that  attempting  to  load  the  DLL  version  of  the  plugin  without  these  filea  in  place  will 
causa  tha  loading  procass  to  silently  fail:  *1TQ*  cess age a  indicating  why  the  loading  failed  will 
be  generated.  Be  sure  to  run  the  INSTALL  command  after  building  but  before  testing. 

Mote  that  even  with  the  exe  version  of  the  plugin,  the  re sour oe  files 

naist  be  present  in  the  correct  locations  within  the  CHEQ  tree  in  order 
to  successfully  run  the  plugin.  Be  sure  to  run  the  INSTALL  target 
before  starting  a  testing  session. 

Configuring  done 


Fig.  35  Run  Configure  again,  and  the  process  should  complete.  Select  Generate  to  produce 
a  Visual  Studio  project.  Be  sure  you  have  read  and  understood  the  messages  generated  during 
the  configuration  process — they  are  intended  to  alert  you  to  situations  that  may  result  in  a 
failure  of  the  converter  plugin  to  successfully  run,  or  otherwise  compromise  effective  software 
development  work  on  the  converter. 
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W^JSh  f  *  «  brkad  ► 

bikad:  1  iit  *  external  ►  CREQ  ►  build  f 

■*  n 

* 

P  1 

Organic  *  Open 

*  E-mail-  Burn  New  hridcf 

£z  " 

LB  & 

Tf  F*wpirt« 

Documents  library 

Arrange  by: 

Felder  *' 

F“  Desktop 

build 

j£  Downloads 

Name 

Date  rr'iO  Oifit J 

Type 

Size 

* 

i ^  Recent  Place* 

j-  C Makefiles 

5/8/2017  Ifra  AM 

File  folder 

u 

,  Debug 

5/8/2017 10-27  AM 

File  folder 

Jr,  MmSizeRd 

5/8/2017  10:27  AM 

File  folder 

_ 

,  j  Libraries 

Jv.  fteJeuse 

5/8/2017  1027  AM 

File- folder 

■!  Documents 

1  HeMihD labbvfo 

5/B/2017 10:27  AM 

File  folder 

J-  Musk 

&  iibbg-dll 

5/6/2017 10:27  AM 

AppliL.il  ion  eHens... 

sin 

b  Pictures 

J*  Iibbn.dll 

5/8/2017  10:27  AM 

Application  trftnc... 

327  ft! 

-j]  Subversion 

libbrtp.dll 

5/8/2017  10:27  AM 

Application  otens.^ 

567  K 

H  Vidc« 

'■c  libbu.dll 

5/8/2017 10  J7  AM 

Application  extent... 

4&4  K 

libgdiam.dll 

5/8/2017  10:27  AM 

Application  extens... 

52  K 

Computer 

A  liblr4.dll 

5/8/2017 10:27  AM 

Application  eriens... 

53K 

&  (OJ  QSCfak 

Ql  libnmg.dll 

5/8/2017  Kh27  AM 

Application  extens.. 

9G0K 

- 

iS  libpft-dli 

MU  10:27  AM 

Application  extens.,- 

47  K 

Network 

[gj  lihrt.dll 

5/8/2017 10:27  AM 

AppEiCation  eiteni... 

2,468  K 

^  libtinyctfifeacf.dll 

5/8/2017 10:27  AM 

Application  extens,.. 

OK 

;>•  Iibvdi.dll 

5/6/2317 10:27  AM 

Application  «Ktens... 

19  K 

libwdb.dll 

5/8/2017 1KH27  AM 

Application  extens... 

51  K 

£  cpcfiMUR0S.dll 

5/6/2017  IfcCT  AM 

Application  eVttns... 

J.727K 

>,  ffige«.dll 

5/8/2017 Ifl-27  AM 

Application  extens., . 

36* 

5.8/2017  10:27  AM 

Application  extensor 

UK 

iltb3.dll 

5/8/2017  WOT  AM 

Application  extent... 

76K 

!_  cmaJVeJnsttfll.cmake 

5/8/2017 10:23  AM 

CMAKE  Fie 

9  K 

emak^_uninstell.em#ke 

5/8/2017 10t27  AM 

CMAM  File 

:k 

_  CPackCenfig.cmak4 

5/8/2017  10-27  AM 

CMAKE  Fie 

4Kl-J 

lJ  CPackSkrurceCcnfig.cmakt 

5/8/2017  10:27  AM 

CMAKE  FRe 

4  K 

j  trea-bif.dflC 

5/8/2017  10:27  AM 

DAT  Fie 

IK 

:  Sj  CRE02BRL 

5v8/2017 1CK28  AM 

Microsoft  Visual  S... 

OK 

^0  -CREQ2BR.I 

WiCfCSdClViS-ual 


,  CMiakeCflcHe 

0B  AU.BUn.D- 
lS  crw-brf 
3  INSTALL 
3  PACKAGE 


5/8/2017 1<127  am 
5/8/2017 10:23  AM 
5/6/2017 1&:23AM 
5/8/2017  lfr.28  AM 
5/3/2017 10:29  AM 


L 


Tiprf&wuin^nE 

VO-  PigjEtt 
VC#*  P*y«t 
VO*  Piejecl 
VC*  -  Project 


Studio  Solution 


Date  moJifiri:  5/U2U7  10:26  AM 
5iit  5.55  KB 


Dale  ceased  5/8/2017 10:29  AM 


UK 
44  K 
&6  K 
13  K 
UK  ■ 


Fig.  36  Select  the  generated  file  “CRE02BRL”  to  open  the  Visual  Studio  project 
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,”t  .’h!- .  il  -t 

FIE  EKT  vt£w  PftOJCCT  BullX'  TEAM  SQL  TOCiS  TEST  AMALfZi  WlbfitfW  HELP 

O'  I[j  ■  Il  III  l]1  >  Local  Windows  ETebugger  -  u-Jlo  -  [>bjg  - 

csgcpp_ EJgp-brih -issgn-Jtibrpp_ pjrt.tpp_ ulil.cpp 


SGInbvil  > 


■  &  ipirtpiit_pii1ijitrTO_tflnv_"rfp  *■  cinfsj] 


*  Routine  to  output  the  top  level  object  that  is  curr-cntly  displayed  in'  CMO. 

*  ThS*  ti  lfv  r**l  br|Snntnj  pF  the  pt^ctl-iW  Code  -  doit  Collect*  u*#i“ 

-*  srttlnfs  and  call*  this  functliHi-  “/ 

eirtern  “C*  ^oid 

-output  tcp_level  object ( struct  .'■eo  cc<  -  'cln^?,.  ?rcfsdl  imdelj.  •  rnfidlType  t.ue  } 

i 

^*^[CR£©_hiW£_HAtt]; 
char  n™=[CRMJWe_HAJ(]j 
ncTinr_t  *miMe_5-irvedj 
struct  director  +td^  ■  $T  jOIft^NUtt] 

/"  §et  object  naae  V 

if  {Pritf«lUM*eOet(  ode  I,  unaae  )  I*  Pfta_ns;_HO_ERROfl  )  returnj 
{vci<S)  ProHitJ-injIoStrinji  nope >  wna*e); 

/w  S*we  mh  "/ 

rfnne_saucd  -  (]pchfl^_t  * )  bu_ca  £ loc  (wes  len  (wnawe  itl.  slzeof.  (wdiar_£),p  “ERE©  nwe1); 
pc5ncpy{tPiBPe_s»ved>  wn-pw*  wcslen(wnai*e)*l).; 


Quit*  Lhj*ic»i  iQr1+Q>  fi  — ■  D  X 

-  P  .  fa  +*  ^  i 

_ CltHWew  (L  * 

■He  O’ 

*  s  Search*  *  p 

i  ■*+  PACKAGE 
p  *■+  UMNSlAIL 
1  ++  UNL«K 
*  *+  SEfljO^CHtE  K 


±  f  ‘  Thar*  ire  e™j  pesaihliit  las  ■  t  i  cht-  ™  ha-rf  a  nLer-arciij' „  in  which  cast  > *t 

“  need  to  h-alk  it  and  collect  the  objects  to  process,  or  ire  nave  a  single  part 
*  which  we  can  process  directly.  */ 
if  {  type  —  PmjQLjRMT  )  ( 

/*  0^*  pap?  b*ly  ■/ 

c  i  ntc  -  >p-*rfcs  -  > insert  (wn*i<£_s  aved }  i 

nutput_parts(  :info).E 

)  else  if  (  type  ■■  PMJ*H__ASS»*0  >  f 

hi»] k  tht  hierarchy  and  prpe#**  all  nirtlitl  *r*4  pAr't*  mi 

c  iflf  o-i  >a  s  seas  ■  slimier  c(  Hfiue_saved  J ; 

F-oSol  id  'eatvislti  ProAd  iTePart  (eodel)  r  ebjectsjattier.  ^Prc^eatu-reF  S  ltorAction Jc«spanemt_f liter j  { P'-c^ppi 
HH t pi/t_ pa r t  j  {  cirvfoj  f 

fj'nd_e»ptiri,al-seMslies{ 

[^IcJProWindawfteireah  EP*2’_1.iAlUE_1#LISED>  ■ 
c<Jtput_assees(c  lo+c  ) ; 

1  else  -T  * 

-  *  » 

Dutpul  t  fl.  x 

Shaw  putput  I  ura  -  !V 


Epjif’ji  Find  Symbol  ResuAs 


>!r*d-/ 


1c4i_  {be.  Piop_  Tea_ 


Lnlll  ColTfi-  Eh]6  INS, 


Fig.  37  The  target  list  should  include  creo-brl,  which  is  the  primary  target  to  build.  Although 
it  is  not  required  for  building,  opening  the  converter  source  code  files  in  Visual  Studio  is  a 
good  preparation  step  if  you  expect  to  set  breakpoints  or  step  through  the  sources  during 
debugging. 
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L*i.*d<ud  aaqi^i  ^^-3 


j:bkl  .  -! 

F3_E  EOTT  Vim’  HOKCl  PUTID  DEBUG  TEAM  5QI  TQGti  lEST  AH^LYZl  WWDCW  HtlP 
O  5  ■  I*  M  ►  UtiiWfrriiHHMwjgBtr  -  Arts  -  futug  - 


lt»>Mh  JKl£fflbly.£p|i 


lAlLtpp 


o^lfp 


Mrt.o» 


:PP  ' 


J5  -  Q  X 


-  0  X  C 


"  to  ■Wfprt  th«e  tpp  Irwrl  th?T  1*.  wrTfretlj  dls-ptaltt'd  !"•  CHEtt- 

“  *Sl  Li  the  npp]  nfann  I  ng  pf  (*i*  pr«|Tling  C-rff  -  toit  wll  «t*  WSf 

■'  WtO"*.!  end  c-pllt  th.il  funq-ti^n-  */ 
ent-j-m  “C"  void 

-  1jyt!Wt_tQp_level_4*J«t  (  struct  I  ■  ;•■•  .Intc  Vnlf,  S-C*)l  =  -  V  a;  iTypv  ■  ) 

( 

-chjrjt  ^■xEtSIDJW^.'WO] 
n w f r R [0_ W+E 3 ; 

McNr^t  “><*1  ■*C_Lm4; 

itnrct  »:!,recl5r  "tip  ■  BT_D]«_»Mu; 


iiduht 

[.  +*  AJ  L  . BUILD 
P  **  imi-bil 

p  **  IhivTA  .  L 
P  +*  PACKAGE 
l  **  LNNSTAU 
b  +-  LftAOCE 
b  +■  HA&.CHffli 


■  P 


I*  net  object  «*w  *j 

U  CProM^lHo^rtirtC  ■NTrt-lj  -n| 
(void  JPrmiltrinf  Toitr  Lnu^ 


IPX-  ]  f*  PBt?.TlC=lia_[=HW  )  return; 
0J 


:)tl,  sLiept(>-x^»r^t!i,  JCRm  nix'); 


i  ■  live  n«  '  t 

>>^*^_saved  ■  t  ■J.bp_cti3«(»ciLen.;^ipi 

PMCj  WCsl*«*[Nnfl«>+l)  j 

t*  There  ere  Lw  p-ysi  Lbiilties-  -  tlther  we  hive1  *  hlwirchjh  in  tAtlth.  cose  we 
"  need  to  wilt  it  md  collect  tt»e  oh-jecti  bo  or«e-55h  or  me  I'l-x  t  tingle  pirt 
■  MvLch  we  cm  '•rocesi  directly  V 
if  C  type  "i  TO,i«IJi.J»AflT  }  ^ 

J'  Oik  pare  *nly  mj 
{ Erf  c  -  ipares->ir'sert  (up  aw  _  lived  3 ; 

(Mtput .• r  ;i; 

}  else  Lf  f  cvj*  —  PMJVHH.JISSEW1.Y  )  { 

fm  Milk  the  hier*nchy  and  prcceu  ill  nece-sury  ismbllei  ind  p*rtt  V 
i  j-1  re  -  laiiHi- > Insert  [nTiaw^s.»v«iJ ; 

prcSOitidFencVis.itCP^otVllToPertc^cceLj,  objects. j(*therh  {ProFet-  jre'LLteracci:  Jcoaponent^filte^j  CPv'cJppPatH)c]".i‘o}; 

o^tput_parti.(-  "If 

fjnj  e*pty_iiM*lie-5[-  .  :  }; 

(votd‘jPrtMndi!i*efr«h  [Pft&_^WE  JJNUSEim 
output  .  “■  J[ 

3-  < 

e-eo  Loa:  ■  .  "Tdd  Je-^e!  oblect  is-  .-ether  part  -o-  «S£HB-.v,  jLsktj'.  npeel-: 


Jhm  rrnm:  BuiU  * ;  tm  ~!a  M 

If  pirt.^is^  _ 
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Fig.  38  Building  the  target  should  succeed  and  produce  creo-brLdll.  If  not,  debugging  work 
starts  now. 


After  producing  creo-brl.dll  successfully,  the  next  step  depends  on  what  licensing 
the  developer’s  Creo  Parametric  is  set  up  to  use.  The  CMake  process  issues  a 
warning  if  the  user’s  Creo  Parametric  settings  are  not  configured  to  load  the 
Pro/TOOLKIT  license  at  Creo  startup.  If  Creo  Parametric  does  not  load  the 
necessary  toolkit,  the  plugin  will  eventually  fail  to  load,  notifying  the  user  of  a 
locked  DLL.  If  this  is  not  what  is  expected,  correct  the  Creo  Parametric  installation 
to  load  Pro/TOOLKIT  at  startup.  If  you  prefer  not  to  do  so  (i.e.,  if  you  only  expect 
to  compile  and  test  once)  run  the  UNLOCK  target  now,  before  running  the 
INSTALL  target.  This  is  not  recommended  when  doing  any  sort  of  extensive 
development,  as  it  will  lock  a  Pro/TOOLKIT  license  for  15  min — for  development, 
it  is  much  better  to  load  Pro/TOOLKIT  in  Creo  Parametric  at  run  time. 
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For  the  standard  situation  where  a  developer  needs  to  debug  a  running  plugin, 
Figs.  39-41  illustrate  how  to  use  a  compiled  plugin  and  Visual  C++  to  step  through 
the  source  code. 
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Fig.  39  Before  the  plugin  can  be  loaded,  even  for  testing,  it  is  necessary  to  run  the  INSTALL 
target  to  make  sure  all  of  the  required  files  are  in  their  correct  locations  in  the  Creo 
Parametric  directories 
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Fig.  40  If  Creo  Parametric  and  the  plugin  are  now  running  and  ready  for  debugging,  then 
attach  Visual  Studio’s  debugger  to  the  running  process 
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Fig.  41  From  the  list  of  processes,  select  the  one  that  shows  either  Creo  Parametric  (if  the 
plugin  is  not  yet  running)  or  Creo  to  BRL-CAD  (if  the  plugin  is  running)  and  select  Attach. 
Once  this  is  complete,  the  running  plugin  will  respect  break  points  defined  in  Visual  Studio 
and  the  conversion  process  can  be  debugged. 


Once  the  plugin  is  running  to  a  developer’s  satisfaction,  the  final  step  is  to  prepare 
a  redistributable  version  of  the  plugin  that  users  can  install.  The  CPack  tool  is  used 
to  create  archives,  but  it  is  crucial  for  developers  to  remember  to  perform  the 
“UNLOCK”  step  before  creating  the  archives,  as  illustrated  in  Figs.  42  and  43. 
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Fig.  42  Once  the  plugin  is  deemed  ready  for  distribution,  make  sure  the  build  type  is  set  to 
Release,  build  the  creo-brl  target  to  make  sure  everything  is  up  to  date,  and  then  run  the 
UNLOCK  target.  This  will  lock  up  a  Pro/TOOLKIT  license  for  15  min,  but  also  results  in  a 
DLL  that  can  be  used  by  other  Creo  Parametric  installations. 
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Fig.  43  Once  the  DLL  is  unlocked,  the  PACKAGE  target  may  be  used  to  generate  a  .zip  file 
and  a  Nullsoft  Scriptable  Install  System  (NSIS)  installation  executable  for  distribution 


6.  Future  Work 


While  the  essential  functionality  of  the  original  Pro/E  conversion  plugin  has  been 
reproduced  in  Creo  Parametric  3  and  a  number  of  improvements  added,  additional 
work  would  substantially  improve  the  existing  capabilities.  Immediately  apparent 
improvements  would  be  to  complete  the  solidity  testing  routine  for  mesh  generation 
and  add  an  ability  to  translate  the  NURBS  boundary  representation  (B-Rep)  solid 
descriptions  over  directly  to  BRL-CAD  without  tessellation.  Longer-term 
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directions  to  explore  include  using  BRL-CAD’s  own  tessellation  routines  as  an 
alternative  to  those  in  Creo  Parametric  for  more  robust  solid  generation  and 
applying  CSG  conversion  research8  to  imported  Creo  NURBS  B-Reps  as  a  means 
of  size  reduction. 
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List  of  Symbols,  Abbreviations,  and  Acronyms 


3-D 

3-dimensional 

ARL 

US  Army  Research  Laboratory 

B-Rep 

boundary  representation 

BoT 

bag-of-triangles 

BRL 

Ballistic  Research  Laboratory 

CAD 

computer-aided  design 

CSG 

constructive  solid  geometry 

MUVES 

Modular  Unix-based  Vulnerability  Estimation  Suite 

NSIS 

Nullsoft  Scriptable  Install  System 

NURBS 

Non-Uniform  Rational  B-Spline 

Pro/E 

Pro/ENGINEER 

STL 

STereoLithography 

V/L 

vulnerability/lethality 
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